home *** CD-ROM | disk | FTP | other *** search
/ NOVA - For the NeXT Workstation / NOVA - For the NeXT Workstation.iso / Apps / Utilities / Other / TimeMon / README < prev    next >
Text File  |  1992-12-26  |  3KB  |  82 lines
  1. /*
  2.   README
  3.  
  4.     README file for the TimeMon program.
  5.  
  6.   Copyright 1991 Scott Hess.  Permission to use, copy, modify, and
  7.   distribute this software and its documentation for any purpose
  8.   and without fee is hereby granted, provided that this copyright
  9.   notice appear in all copies.  The copyright notice need not appear
  10.   on binary-only distributions - just in source code.
  11.   
  12.   Scott Hess makes no representations about the suitability of this
  13.   software for any purpose.  It is provided "as is" without express
  14.   or implied warranty.
  15. */
  16.  
  17. Changes from TimeMon-2.1 to TimeMon-2.2
  18.  
  19. I modified the routines that get the CPU usage info to use the
  20. apparently undocumented table() function of mach.  This function
  21. returns a structure which contains all of the information I needed,
  22. and is actually much easier to use than the /dev/kmem stuff.  Since
  23. the function is undocumented, I included code which _should_
  24. automagically fall-back to the /dev/kmem reading stuff if needed.
  25.  
  26. The upshot is that TimeMon no longer requires setgid kmem.  This
  27. is great, since it plugs a security hole.  Thus, the installation
  28. notes no longer apply.
  29.  
  30. If, in the future, NeXT should decide not to include the table()
  31. function, the /dev/kmem functionality is still there.  By doing
  32. 'make "CFLAGS= -DUSEKMEM=1", the original TimeMon-2.1 program is
  33. produced.
  34.  
  35. The other change is that I updated all those nasty copyright notices.
  36. I snarfed most of the notice from the BSD sources (somewhere or
  37. other), and seemed to have forgotten that 1988 didn't really make
  38. much sense WRT NeXT and myself.  They're now updated to 1991.
  39.  
  40. README from TimeMon-2.1 follows:
  41.  
  42. Find enclosed the new, improved TimeMon program.  TimeMon monitors
  43. your system and tells you where the cycles are going - to kernel
  44. processing, user processes, "nice" processes, and idle time.  OK,
  45. so it's a bit coarse.
  46.  
  47. TimeMon2.1 has been much improved over the original TimeMon program.
  48. You'll first notice that TimeMon does the output display in the
  49. program's icon, as opposed to using a separate window.  I found
  50. that the separate window was continually losing itself, and also
  51. really didn't give me all the information I wanted.  The new version
  52. gives more information than the original, in a more compact, yet
  53. more readable form.
  54.  
  55. Installation
  56.  
  57. Version 2.1 of TimeMon compiles and runs under NextStep2.1.  It
  58. more than likely works under 2.0 (I use no weird stuff - in fact,
  59. most of the remotely weird stuff is based on code that worked in
  60. NextStep1.0, also).  It will not work under NextStep1.0, and I have
  61. no plans for such a port.  Get yourself upgraded, it's worth it.
  62.  
  63. To install TimeMon, do your make in the TimeMon-2.1 directory, run
  64. 'strip TimeMon' to remove debugging symbols, and move the executable
  65. to the appropriate place.  Then you must incant:
  66.  
  67. chgrp kmem TimeMon ; chmod g+s TimeMon
  68.  
  69. to the command line as root.  As shipped, NeXT's allow group kmem
  70. read access to /dev/kmem, which TimeMon needs in order to read the
  71. required data from it.  Note that this is much safer than the
  72. earlier TimeMon, which wanted to be setuid root.  Technically, that
  73. wasn't really required, except that I tested the effective uid and
  74. didn't run if it wasn't root . . .
  75.  
  76. Later,
  77. scott hess
  78. RR#4 Box 227
  79. Pipestone, MN  56164
  80. (507) 825-2788
  81. scott@gac.edu
  82.